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FIG. 3 
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FIG. 5 
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FIG. 6 
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FIG. 7A 



/* -*Java-*- 



* 

* File: MATContactCounts.java 



* RCS: $Header: $ 

* Description: 

* Author: John Hainsworth 

* Created: Fri Sep 03 15:17:42 1999 

* Modified: Thu Sep 09 16:15:41 1999 (Michael L Creech) mike@home 

* Language: Java 

* Package: com.attresearch.matemai! 
Status: Experimental (Do Not Distribute) 



(c) Copyright 1999, AT&T, ail rights reserved. 



* 
* 

* 

Revisions: 



Thu Sep 09 16:15:31 1999 (Michael L Creech) mike@home 

Added getOldest( ), and getNewest( ). 
Fri Sep 03 15:17:46 1999 (Michael L Creech) mike@home 

Made getOrderingValue( ) public. 



v 



package com.attresearch.matemail; 



import javaJo.PrintWriter; 
import java.io.IOException; 
import java.util.Date; 

/** Statistics about mail to and from one e-mail address. 

* These statistics ore all redundant with respect to the data, 

* so none of them are saved with the data, 

v 
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FIG. 7 A continued 



public class MATContactCounts j 
/** Copyright (c) 1999 AT&T labs */ 
static public String Copyright = "Copyright (c) 1999 AT&T Labs"; 

static final private int CountNONE = -1; 
static final private double DCountNONE = -1.0; 

static final int FromME = 0; 

static final int FromOTHER = FromME + 1; 

static private final int From_N = FromOTHER + 1; 

static private final String StrFrom[ ] = | "My", " " |; 

/** seen in an original message */ 

static final int KindCOMPOSITION = 0; 

/** seen in a reply message */ 

static final int KindREPLY = KindCOMPOSITION + From_N; 

/** seen in a forwarded message */ 

static final int KindFORWARD = KindREPLY + FR0M_N; 

static private final int Kind_N = KindFORWARD + From_N; 

static private final String StrKind[ ] = | " ", "Repl", "Fwd" j; 

/** seen in a "To:" header */ 

static final int WhereTo = 0; 

/** seen in a "From:" header */ 

static final int WhereFROM = WhereTO + Kind_N; 

/** seen in a "Cc:" header */ 

static final int WhereCC = WhereFROM + Kind_N; 

/** seen in a "Bcc" header */ 

static final int WhereBcc = WhereCC + Kind_N; 

static private final int Where_N = WhereBCC + Kind_N; 

static private final String StrWhere[ ] = | "To", "From", "Cc", "Bcc" j; 
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FIG. 7B 



jj Java will initialize these to 0 

private int counts[ ] = new int [Where„N]; 

Date newest; 
Date oldest; 

public Date getOldest ( ) 
return oldest; 



/** @param what Should always be of the form (From?? + Kind?? + Where??) */ 
void incrementCount(Date d, int what) { 
counts[what]++; 
if (null != d) | 
if (nill == newest) { 
oldest = newest = d; 
| else { 

long nms = d,getTime( ); 
if (nms > newest.getTime( ) ) { 
newest = d; 

\ else if (nms < oldest.getTime( ) ) j 
oldest = d; 



/** @param what Should always be of the form (From?? + Kind?? + Where??) */ 
int getCount(int what) j 
return countsjwhat]; 



public Date getNewest( ) 



return newest; 
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FIG. 7B continued 



/** Set all counters to zero. */ 
void clear( ) j 
int i = 0; 

while (i < Where_N) j 
counts[i++] = 0; 

nonZeroTotal = CountNONE; 
orderingValue = CountNONE; 
oldest = newest = null; 
duration = CountNONE; 
density = CountNONE; 
freshness = DCountNONE; 



/** Get total number of messages this contact actually appeared in. 

* Since we add To:s to Cc:s and Cc:s to Bcc:s, we just need to count 

* Fromrs and Bcc:s. */ 
private int getMessageCount( ) j 

return (counts [FromME + KindCOMPOSITION + WhereFROM] + 
counts [FromME + KfndREPLY + WhereFROM] + 
counts 'FromME + KindFORWARD + WhereFROM] + 
counts 'FromOTHER + KindCOMPOSITION + WhereFROM] + 
counts FromOTHER + KindREPLY + WhereFROM] + 
counts FromOTHER + KindFORWARD + WhereFROM] + 
counts FromME + KindCOMPOSITION + WhereBCC] + 
counts FromME + KindREPLY + WhereBCC] + 
counts FromME + KindFORWARD + WhereBCC] + 
counts FromOTHER + KindCOMPOSITION + WhereBCC] + 
counts FromOTHER + KindREPLY + WhereBCC] + 
counts [FromOTHER + KindFORWARD + WhereBCC]); 
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FIG. 7C 



private long duration = CountNONE; 
public long getDuration( ) j 
if (CountNONE — duration) \ 
if (null != oldest) j 

duration = newest.getTime( ) - oldest.getTime( ); 
\ else | 
duration = 0; 



return duration; 



private long density = CountNONE; 
public long getDensity( ) { 
if (CountNONE == density) j 

lona dur = getDuration( ); 

if (0 < dur) | 

density = getMessageCount( ) / dur; 
| else j 
density = 0; 



return density; 



private double freshness = DCountNONE; 
public double getFreshness( ) j 
if (DCountNONE == freshness ) j 
freshness = ( ( (double) qetDensityf ) ) / 

^ ( (double) ( (new Date( ) ) .getTime( ) - newestgetTime( ) ) ) ); 

return freshness; 
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FIG. 7C continued 



private int noneZeroTotal = CountNONE; 
int getNonZeroTotal ( ) j 
if (CountNONE == nonZeroTotal) | 

nonZeroTotal = 0; 

int i = 0; 

while (i < Where_N) \ 
nonZeroTotal += counts [i]; 
i += 1; 



return nonZeroTotal; 



private int orderingValue = CountNONE; 
// MLC: 

public int getOrderingValue ( ) j 
if (CountNONE == orderingValue) j 
ordeingValue = 

counts [FromME + KindREPLY + WhereTO] * 1000000 + 
counts FromME + KindCOMPOSITION + WhereTO] * 10000 + 
counts 'FromOTHER + KindREPLY + WhereFROM] * 100 + 
counts [FromOTHER + KindCOMPOSITION + WhereFROM) * 100 + 
getNonZeroTotal ( ); 

return orderingValue; 
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private String printl (String leader, PrintWriter ps, int what) 
throws IOException \ 
if (0 != counts [what]) { 

int iFrom = what % From„N; 

int iKind = (what % Kind_N) / FrorruN; 

int iWhere = what / Kind_N; 

ps.print (ieader+StrFrom[iFrom]+StrKind[iKind]+StrWhere[iWhere]+ 

"="+counts[what] ); 
leader = " 

I 

return leader; 



public void print (PrintWriter ps, int format) throws IOException j 
switch (format) j 
case MATData.FormatANALYSIS: 

String leader = " |"; 

int what = 0; 

leader = printl (leader, ps, FromME + KindREPLY + WhereTO); 
leader = printl (leader, ps, FromME + KindCOMPOSITION + WhereTO); 
leader = printl leader, ps, FromOTHER + KindREPLY + WhereFROM); 
leader = printl (leader, ps, FromOTHER + KindCOMPOSITION + WhereFROM); 
while (what < Where_N) j 
switch (what) \ 

case FromME + KindREPLY + WhereTO: 
case FromME + KindCOMPOSITION + WhereTO: 
case FromOTHER + KindREPLY + WhereFROM: 
case FromOTHER + KindCOMPOSITION + WhereFROM: 

break; 
default: 

leader = printl (leader, ps, what); 
break; 

I 

what++; 

if (leader.equals(" ") ) j 
ps.print ("j"); 

I 

break; 
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FIG. 7D continued 



case MATData.FormatTERMINAL: 
int what2 = 0; 
String Ieader2 = " j"; 
while (what2 < Where_N) | 
leader = printl (Ieader2, ps, what2++); 

if (Ieader2.equals (" ") ) | 
^ ps.print ("j"); 

ps.print (" score="+getOrderingValue ( ) ); 
break; 

case MATData.FormatDATABASE: 
break; 

I 

1 
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package com.attresearch.mat.email; 

import com.attresearch.mat.utility.UniqueIDs; 

import com^attresearch.matutility.NumberedMember; 

import java.utilfnumeration; 

import javaJo.PrintWriter; 

import java.io.IOException 

import javaJo.StringWriter; 

import java.utiLDate; 

/** A list of contacts that appeared together on a To, Cc, or Bcc line. */ 

public class MATContactGroup extends UniquelDs { 
/** Copyright (c) 1999 AT&T Labs */ 

static public String Copyright = "Copyright (c) 1999 AT&T Labs"; 

/** ©serial cc not stored */ 
private MATContacts cc; 

// MLC: 

public MATContacts getMATContacts ( ) 
return cc; 



public MATContactGroup (MATContacts cc) { 
this.cc = cc; 

i 

public Enumeration elements ( ) j return elements (cc); j 

public void hideUnimportantMembers (int threshold) j 
Enumeration e = elements (cc); 
while (e.hasMoreElemets { ) ) \ 

((MATContact) e.nextElement ( ) ) .hidelfUnimportant (threshold); 
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FIG. 8 A continued 



public boolean containsMe ( ) j 
Enumeration e = elements (cc); 
while (e.hasMoreElements ( ) ) j 
if ( ( (MATContact) e.nextElement ( ) ) JsMe ( ) ) j 
return true; 



return false; 



/** ©return Unique id of removed member. */ 
public int removeMe ( ) j 
int i = 0; 

Enumeration e = elements (cc); 
while (e.hasMoreElements ( ) ) \ 
MATContact c = (MATContact) e.nextElement ( ); 
if (cisMe ( ) ) j 
removeElementAt (i); 
return c.getUniqueld ( ); 

\ 

i 

return NumberedMember.IdNONE; 

i 
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public MATContactGroup updateToRemoveMe ( ) { 
int removedMe = removeMe ( ); 
if (NumberedMemberJdNONE != removedMe) | 

int others = toMATContactID ( ); 

MATContactGroup meGroup = new MATContactGroup(cc); 

meGroup.addElement (removedMe); 

meGroup.addElement (others); 

meGroup.sortlDs ( ); 

return meGroup; 
( else | 

return null; 



public int toMATContactID ( ) j 
switch (size( ) ) j 
case 0: 

return NumberedMemberJdNONE; 
case 1: 

return uniqueldAT (0); 
default: 

int removedMe = removeMe ( ); 

if (NumberedMemberJdNONE != removedMe) j 

int others = toMATContactID ( ); 

MATContactGroup meGroup = new MATContactGroup(cc); 

meGroup.addElementf removedMe); 

meGroup.addElement(others); 

meGroup.sortlDs ( ); 

MATContact c = cc.find (meGroup); 

c.setHidden(true); 

return c.getUniquelD ( ); 
\ else \ 

sortlds ( ); 

return cc.find(this).getUniqueId ( ); 
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FIG. 8B continued 



/** Calls |@link com.attjesearch.matemaiLMATContact|incrementCouirt(Date, int)| 
* for each member */ 
void incrementCount(Date d, int what) [ 
Enumeration e = elements(cc); 
while (e.hasMoreElements( ) ) j 
((MATContact)e.nextElement( ) )jncrementCount(d, what); 

/** Needed by the contact the viewer. */ 

// This method MUST use cc, and cannot get it as an argument 

// This is the only true reason that cc must be a member of this object. 

public String toString( ) j 

StringWriter sw = new StringWriter( ); 

PrintWriter ps = new PrintWriter(sw); 

try j 

print(ps, cc, " ", MATData.FormatADDRESS_ONLY); 
| catch (IOException e) j 

return sw.toString( ); 

I 1 



